WPS 加载项开发 > 表格 API 参考 > ListObjects > 方法 > ListObjects.Add 方法
创建新的列表对象。

语法

表达式.Add(SourceType, Source, LinkSource, HasHeaders, Destination)

表达式   一个代表 ListObjects 对象的变量。

参数

名称 必选/可选 数据类型 说明
SourceType 可选 XlListObjectSourceType 表示查询的来源类型。
Source 可选 Variant 当 SourceType 为 xlSrcRange 时，它是代表数据源的 Range 对象。如果省略该参数，Source 的默认值将是列表区域检测代码返回的区域。当 SourceType 为 xlSrcExternal 时，它是一个 String 值数组，用于指定与数据源的连接，包含以下元素：
  • 0 ― SharePoint 网站的 URL
  • 1 ― ListName
  • 2 ― ViewGUID
LinkSource 可选 Variant Boolean 型。表示外部数据源是否链接到 ListObject 对象。如果 SourceType 为 xlSrcExternal，则默认值为 True。如果 SourceType 为 xlSrcRange，则此参数无效，如果不省略它，将会返回一个错误。
TableStyleName 可选 Variant 一个 XlYesNoGuess 常量，它指示正在导入的数据是否有列标签。如果 Source 没有标题，ET 将自动生成标题。
Destination 可选 Variant 一个 Range 对象，作用是将一个单元格引用指定为新列表对象左上角的目标区域。如果 Range 对象引用多个单元格，则会产生错误。当 SourceType 设置为 xlSrcExternal 时，必须指定 Destination 参数。如果 SourceType 设置为 xlSrcRange，则忽略 Destination 参数。目标区域所在的工作表必须是包含 expression 所指定的 ListObjects 集合的工作表。新列的插入位置将是 Destination 以适应新列表。因此，现有数据不会被覆盖。

返回值
一个 ListObject 对象，它代表新的列表对象。

说明

当列表有标题时，第一行单元格将转换为 Text（如果还未被设为文本）。转换将基于单元格的可见文本。这意味着，如果有一个日期值，该日期值的 Date 格式随区域设置的更改而更改，则对列表的转换可能产生不同的结果，具体取决于当前的系统区域设置。而且，如果标题行中有两个单元格包含相同的可见文本，则会追加递增的 Integer 以使每个列标题唯一。

示例

下例在默认 ListObject 集合中添加新的 ListObjects 对象（该对象基于 Microsoft SharePoint Foundation 网站的数据），并将列表放在工作簿中第一个工作表的 A1 单元格中。

注释
以下代码示例假设您会将 strServerName 和 strListGUID 变量替换为有效的服务器名称和列表 GUID。此外，服务器名称后面必须是“/_vti_bin”，否则本示例将不运行。
示例代码 
let objListObject = ActiveWorkbook.Worksheets.Item(1).ListObjects.Add(xlSrcExternal, Array(strServerName, strListName, strListGUID), true, xlGuess, Range("A10"))


请参阅